The PostScript Procedure Set Control ('prec') Resource(IM:XP)

Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 6 - Printing Resources / Printing Resources Reference

Resources Used Only in Printer Drivers

The PostScript Procedure Set Control ('prec') Resource
The PostScript procedure set control ('prec') resource, of type gxPostscriptProcSetControlType, is used with PostScript drivers to define a procedure set that can be downloaded to a PostScript printer. This resource is optional.
Figure 6-28 shows the structure of a procedure set control resource.
Figure 6-28 The PostScript procedure set control resource

The procedure set control resource contains naming, version, and memory information about the procedure set, followed by the IDs of the resources that comprise the procedure set.

Procedure set name. The Pascal string name of the procedure set.
Procedure set version. The procedure set type. This is a fixed version number.
Revision. The revision number (an integer) of this procedure set.
Memory usage. The amount of printer memory required for the procedure set.
Count. The number of resources that comprise the procedure set.

Each procedure in the set is defined in a resource. Each entry in the array consists of the ID of the procedure resource and a flag that specifies what to do with the procedure data.

Resource ID. The ID of the resource containing a PostScript procedure.
Flags. A value that describes what to do with the data in the resource. The constants that you can use in this field are shown in Table 6-37.
Table 6-37 PostScript procedure data flags
Constant Value Explanation
donothing 0 The imaging system should send the entire contents of this resource to the output device without modification.
dumpwidestring 1 The imaging system needs to treat the first two bytes (the first short) of the resource as the number of bytes to send to the printer. That many bytes, starting at the third byte, are then sent to the output device without modification.
dumpstringlist 2 The imaging system needs to treat the resource like a string list ('STR#') resource. The imaging system dumps each string after appending a line feed and carriage return to the end of each.
converttohex 0x0100 This is a modifier that specifies that the imaging system needs to convert the data to hexadecimal format before sending it to the output device. You can specify this modifier with the donothing or dumpwidestring flags; however, you cannot use it in conjunction with the dumpstringlist flag.

The string list resource is described in Inside Macintosh: Macintosh Toolbox Essentials.

**Table 6-37 PostScript procedure data flags**
Constant	Value	Explanation
donothing	0	The imaging system should send the entire contents of this resource to the output device without modification.
dumpwidestring	1	The imaging system needs to treat the first two bytes (the first short) of the resource as the number of bytes to send to the printer. That many bytes, starting at the third byte, are then sent to the output device without modification.
dumpstringlist	2	The imaging system needs to treat the resource like a string list (`'STR#'`) resource. The imaging system dumps each string after appending a line feed and carriage return to the end of each.
converttohex	0x0100	This is a modifier that specifies that the imaging system needs to convert the data to hexadecimal format before sending it to the output device. You can specify this modifier with the `donothing` or `dumpwidestring` flags; however, you cannot use it in conjunction with the `dumpstringlist` flag.